Manage orders - Gets a list of product promotions.

获取合作伙伴的可用促销。

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}

URI 参数

名称 必需 类型 说明
version
path True

string

country
query

string

国家/ 地区。

segment
query

string

段。

请求头

名称 必需 类型 说明
Authorization True

string

授权持有者令牌

ms-correlationid

string

用于在内部跟踪请求。 如果未提供 ms-correlationid,则服务器将为每个请求生成一个新请求

MS-CV

string

用于在内部跟踪请求。 如果未提供 MS-CV,服务器将为每个请求生成一个新请求

ms-requestid

string

用于请求的幂等性。 如果未提供 ms-requestid,服务器将为每个请求生成一个新请求

响应

名称 类型 说明
200 OK

ResourceCollection[Contracts.V1.Models.ProductPromotion]

请求成功。 响应正文将包含合作伙伴的促销列表。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

输入缺失或无效。 响应正文将提供错误详细信息。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

请求未通过身份验证。 客户端需要首先通过合作伙伴 API 服务进行身份验证。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

请求已经过身份验证,但被拒绝,因为调用方无权调用该请求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

找不到资源或未与给定输入参数一起使用。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

合作伙伴 API 服务或其某个依赖项未能满足请求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

定义

名称 说明
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm
Link
ResourceAttributes
ResourceCollection[Contracts.V1.Models.ProductPromotion]
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Contracts.V1.Models.ProductPromotion

名称 类型 说明
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

名称 类型 说明
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

名称 类型 说明
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

名称 类型 说明
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

名称 类型 说明
billingCycle

string

duration

string

名称 类型 说明
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

名称 类型 说明
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.ProductPromotion]

名称 类型 说明
attributes

ResourceAttributes

items

Contracts.V1.Models.ProductPromotion[]

links

ResourceLinks

totalCount

integer

名称 类型 说明
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

名称 类型 说明
key

string

value

string